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Overview 


The LiveCode engine has undergone a large quantity of changes for the 7.0 release. The way values of 
variables are stored internally has been changed - in particular where before the engine used C-strings, it 
now uses a reference counted MCStringRef type. Every bit of code that displays text in LiveCode has been 
updated, and all the platform-specific API functions that manipulate characters now use the Unicode 
versions; as a result LiveCode is now fully Unicode compatible. 


The implementation of Unicode compatibility necessitated a change to the stack file format, which means 
stacks saved in 7.0 format are not compatible with earlier versions of LiveCode. However you can still save 
stacks in legacy formats using the dropdown menu in the Save As... dialog. 


The other significant change to engine internals is the work done on syntax refactoring. The code that deals 
with statement execution, function evaluation and property access has been cleaned up and separated out 

from the parsing code, and moved into distinct modules based on functionality. This represents a major first 
step towards being able to implement Open Language. 


Known issues 


Every effort has been made to ensure that externally, the engine behaviour is identical to the current 
unrefactored release. In other words, users should not notice any difference in functionality in their existing 
stacks. 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 
e The engine files are much larger than previous versions due to inclusion of ICU data 


Platform support 

The engine supports a variety of operating systems and versions. This section describes the platforms that 
we ensure the engine runs on without issue (although in some cases with reduced functionality). 
Windows 

The engine supports the following Windows OSes: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 


Note: On 64-bit platforms the engine still runs as a 32-bit application through the WoW layer. 


Linux 
The linux engine requires the following: 


e Supported architectures: 


32-bit or 64-bit Intel/AMD or compatible processor 
32-bit ARMvé6 with hardware floating-point (e.g. RaspberryPi) 


e Common requirements for GUI functionality: 


GTK/GDK/Glib 2.24 or later 

Pango with Xft support 

(optional) esd - required for audio output 

(optional) mplayer - required for media player functionality 
(optional) /cms - required for color profile support in images 
(optional) gksu - required for privilege elevation support 


e Requirements for 32-bit Intel/AMD: 
glibc 2.3.6 or later 

e Requirements for 64-bit Intel/AMD: 
glibc 2.15 or later 

e Requirements for ARMv6: 


glibc 2.7 or later 
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Note: The GUI requirements are also required by Firefox and Chrome, so if your Linux distritution runes one 


of those, it will run the engine. 


Note: If the optional requirements are not present then the engine will still run but the specified features will 


be disabled. 


Note: It may be possible to compile and run LiveCode Community on other architectures but this is not 


officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 


Note: The engine runs as a 32-bit application regardless of the capabilities of the underlying processor. 
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Setup 


Installation 


Each distinct version has its own complete folder — multiple versions will no longer install side-by-side: on 
Windows (and Linux), each distinct version will gain its own start menu (application menu) entry; on Mac, 
each distinct version will have its own app bundle. 

The default location for the install on the different platforms when installing for ‘all users' are: 


e Windows: <x86 program files folder>/RunRev/ LiveCode 7.1.0 
e Linux: /opt/runrev/livecode-7.1.0 
e Mac: /Applications/ LiveCode 7.1.0.app 


The default location for the install on the different platforms when installing for 'this user’ are: 


e Windows: <user roaming app data folder>/RunRev/Components/LiveCode 7.1.0 
e Linux: ~/.runrev/components/livecode-7.1.0 
e Mac: ~/Applications/ LiveCode 7.1.0.app 


Note: If your linux distribution does not have the necessary support for authentication (gksu) then the 
installer will run without admin privileges so you will have to manually run it from an admin account to install 
into a privileged location. 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible from 
the appropriate pane in the control panel. 

On Mac, simply drag the app bundle to the Trash. 

On Linux, the situation is currently less than ideal: 


e open a terminal 
e cd to the folder containing your rev install. e.g. 


cd /opt/runrev/livecode-7.1.0 
e execute the .sefup.x86 file. i.e. 


./.setup.x86 


e follow the on-screen instructions. 


Reporting installer issues 


If you find that the installer fails to work for you then please file a bug report in the RQCC or email 
support@runrev.com so we can look into the problem. 
In the case of failed install it is vitally important that you include the following information: 


e Your platform and operating system version 

e The location of your home/user folder 

e The type of user account you are using (guest, restricted, admin etc.) 

e The installer log file located as follows: 

e Windows 2000/XP: <documents and settings folder>/<user>/Local Settings/ 
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e Windows Vista/7: <users folder>/<user>/AppData/Local/RunRev/Logs 
e Linux: <home>/.runrev/logs 
e Mac: <home>/Library/Application Support/Logs/RunRev 


Activation 


The licensing system ties your product licenses to a customer account system, meaning that you no longer 
have to worry about finding a license key after installing a new copy of LiveCode. Instead, you simply have 
to enter your email address and password that has been registered with our customer account system and 
your license key will be retrieved automatically. 

Alternatively it is possible to activate the product via the use of a specially encrypted license file. These will 
be available for download from the customer center after logging into your account. This method will allow 
the product to be installed on machines that do not have access to the internet. 


Multi-user and network install support (4.5.3) 


In order to better support institutions needing to both deploy the IDE to many machines and to license them 
for all users on a given machine, a number of facilities have been added which are accessible by using the 
command-line. 

Note: These features are intended for use by IT administrators for the purposes of deploying LiveCode in 
multi-user situations. They are not supported for general use. 


Command-line installation 


It is possible to invoke the installer from the command-line on both Mac and Windows. When invoked in this 
fashion, no GUI will be displayed, configuration being supplied by arguments passed to the installer. 

On both platforms, the command is of the following form: 

<exe> install noui options 

Here options is optional and consists of one or more of the following: 


Install the IDE for all users. If not specified, the install will be done for the current 


-allusers 
user only. 
sechineheiati Place a shortcut on the Desktop (Windows-only) 
-Startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The location to install into. If not specified, the location defaults to those 
location described in the Layout section above. 
-log logfile A file to place a log of all actions in. If not specified, no log is generated. 


Note that the command-line variant of the installer does not do any authentication. Thus, if you wish to 
install to an admin-only location you will need to be running as administrator before executing the command. 
As the installer is actually a GUI application, it needs to be run slightly differently from other command-line 
programs. 

In what follows <installerexe> should be replaced with the path of the installer executable or app (inside the 
DMG) that has been downloaded. 

On Windows, you need to do: 

start /wait <installerexe> install noui options 

On Mac, you need to do: 

“<installerexe>/Contents/MacOS/installer’ install noui options 
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On both platforms, the result of the installation will be written to the console. 


Command-line activation 


In a similar vein to installation, it is possible to activate an installation of LiveCode for all-users of that 
machine by using the command-line. When invoked in this fashion, no GUI will be displayed, activation 
being controlled by any arguments passed. 

On both platforms, the command is of the form: 

<exe> activate -file /icense -passphrase phrase 

This command will load the manual activation file from license, decrypt it using the given passphrase and 
then install a license file for all users of the computer. Manual activation files can be downloaded from the 
‘My Products’ section of the RunRev customer accounts area. 

This action can be undone using the following commana: 

<exe> deactivate 

Again, as the LiveCode executable is actually a GUI application it needs to be run slightly differently from 
other command-line programs. 

In what follows <livecodeexe> should be replaced with the path to the installed LiveCode executable or app 
that has been previously installed. 

On Windows, you need to do: 

start /wait <livecodeexe> activate -file /icense -passphrase phrase 

start /wait <livecodeexe> deactivate 

On Mac, you need to do: 

“<livecodeexe>/Contents/MacOS/LiveCode’” activate -file license -passphrase phrase 
“<livecodeexe>/Contents/MacOS/LiveCode” deactivate 

On both platforms, the result of the activation will be written to the console. 


LiveCode 7.1.0 Release Notes 9/24/15 


Engine changes 


mobileLaunchData function (7.1.0-rc-2) 


This new function is available on Android and returns an array containing information from the Intent object 
used to launch the currently running app. 


Available information 


e action -The general action the app was launched to perform. 

e data - The data to operate on. 

e type - The MIME type of the data provided. 

e categories -Additional information about the action to perform. 

e extras -An array of action-specific data set by the calling activity. 


the commandName and the commandArguments (7.1.0-rc-1) 


The bugs 12106 and 12018 have been longstanding issues: $0 is not the command name, but the first 
command argument (which does not follow the way Bash works). 


To solve this issue and avoid breaking any script that uses the current way command arguments are 
retrieved wth LiveCode ($0 being the first commandline argument instead of the command name), we 
introduced two functions to allow the users to access the commandline name and arguments. 


e the commandName returns the command that has been used to start the executable 

e the commandArguments returns a 1-based, numeric array of the commandline arguments if no 
index is given. Returns the arguments at this index otherwise (or empty if the index is < 1 or > 
number of parameters) 


These functions are only implemented for desktop standalone applications and server scripts. They will 
return empty on mobile platforms and in the IDE. 


Multimedia on MacOS with AVFoundation (7.1.0-dp-1) 
What has changed? 


The player object until now used QuickTime/QTKit APIs for audio and video playback. Since both 
QuickTime and QTKit have been deprecated by Apple, we have updated the player to use the new 

AV Foundation API. AVFoundation does not provide a controller for multimedia playback until OSX 10.9 and 
their new control bar is also missing some of the features provided by the QTKIt controller, which required 
us to implement our own controller to ensure backward compatibility. 

We have added three new properties to the player object enabling you to customise the appearance of the 
controller: 


- The hilitecolor of a player is the color of the played area, the colour of the volume area, as well as the 
background color of a controller button when it is pressed. 


- The forecolor of a player is the color of the selected area. The selected area is the area between the 
selection handles. 


- The backcolor of a player is the color of the controller icons (volume icon, play/pause icon, scrub 
back/scrub forward icon). 
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We have also added support for getting information about the download progress of a remote multimedia file: 


- The loadedtime of a player is the time up to which the movie can be played. The download progress is 
also displayed on the controller well. 


You can also query the status property of the player. This property can take either of the values: 
- loading (for remote multimedia files) 

- playing 

- paused 


A new message is added to the player: 

- The playRateChanged message is sent to the player when the rate is changed by the rate scrollbar 
controller. To enable the rate scrollbar controller, hold shift + click on scrubForward/scrubBack buttons of 
the player controller. 


Note AVFoundation player is supported in OSX 10.8 and above. On systems running OSX 10.6 and 10.7, 
LiveCode continues to provide player functionality using the QTKit API. 


Mobile Sockets (7.1.0-dp-1) 


Socket support has been added to the mobile platforms. The following syntax has been added to the iOS 
and Android engines. 


Commands: 


e accept 

e open socket 

e close socket 

e read from socket 
e write to socket 
e secure socket 


Functions: 
e openSockets 
Messages: 


e socketClosed 
e socketError 
e socketTimeout 


Properties: 
e socketTimeoutinterval 


If you are secure sockets, the SSL library must be included in your standalone. To do this for iOS, make 
sure the "Encryption" checkbox of "Basic Application Settings" section on the iOS screen of the Standalone 
Application Settings window is selected. To do this for Android, make sure the "SSL & Encryption" 
checkbox of "Basic Application Settings" section on the Android screen of the Standalone Application 
Settings window is selected. 


Objects are only deleted on idle (7.1.0-dp-1) 


The engine will now flush any recently deleted objects after each command as long as they were 
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created during the current event handling loop. 


If an object is created during one event handling loop, and then deleted during another nested 
event handling loop it won't be flushed until control returns to the original event handling 
loop. 


The upshot is that in tight loops, creating and deleting objects will result in objects being 
flushed immediately, reducing memory usage and making it easier to write object processing 
code which creates and deleted many objects. 


Specific bug fixes (7.1.0) 
(bug fixes specific to the current build are highlighted in bold, reverted bug fixes are stricken through) 


App crash during launch on iPad2 with iOS min version set to 5.1.1 (LiveCode 7.1 
RC+DP) 


15753 
Specific bug fixes (7.1.0-rc-3) 
15898 Building 32-bit slice only causes app to crash on iPad 1 


Specific bug fixes (7.1.0-rc-2) 
15764 Android mobileControlCreate "player" not working 
15756 various codepoint and codeunit functionality broken in standalones 
15743 iOS standalone engine do not build anymore in Debug mode 
15738 The "My LiveCode/Plugins" folder isn't created by the IDE when updating the BAF 
15723 Incorrect wording in Business edition activation screen 
15719 Anerrorin a preOpenStack script aborted openStack 
15718 ‘SSL library not found' error thrown on iOS when using SSL & Encryption library 
15705 strange flash occurring under iOS with visual effect push left/right 
15703 iOS app saved with minimum version 8.4 won't install on a device runnning iOS 8.4 
15685 Fix the path to the OSX standalone engine on Linux 
15684 "extras" key in array returned with mobileGetLaunchData is empty 
15676 Unicode chars in a script can make the Script Editor crash on script opening 


Specific bug fixes (7.1.0-rc-1) 
15700 iOS sockets only accept a single connection 
15692 [Docs] Dictionary entry for "flip" command is missing text 
15675 IDE crashes on startup if DataTree is installed 
15654 ~LiveCode 6.7.7 RC 1/ 7.1.0 DP 1 won't install on 10.6.8 


Exporting text to RTF text generates invalid output if there is the backgroundcolor has been 
changed 


15646 Memory leak when using 'put into of ' 
15642  revZip fails to open archive in 64-bit iOS 
15633 ceiling (“ceil()* synonym) is missing from the dictionary 


15648 


15625 "record sound" is not replacing existing sound file 
15623 machine() returns "unknown" in LiveCode 7.x on OSX 
15619 Opening sqlite on iOS return "revdberror 

15602 Recursionlimit property cannot be set by script > 65535 
15597 ~LiveCode 7 fail to export valid RTF text if lists are used 


15592 
15590 
15514 
15379 
15200 
15096 
13923 
13575 
12108 
11569 
7217 
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memory leak in shell() on Mac 

Crop image within a repeat loop causes crash to desktop after a few iterations 
Blocking socket syntax now works in LiveCode Server. 
Regular Expression with binary input fails in LC 7 

Default cursor doesn't reset when set to empty 

Escape key does not dismiss the 'answer color’ dialog 
formattedHeight of a button is incorrect if button has an icon 
Dictionary - iphoneSetKeyboardReturnKey examples 

Better argument handling for livecode server scripts 
Scrolling a group crashes LiveCode when hiding scrollbar 
selectionChanged not sent on arrow navigation 


Specific bug fixes (7.1.0-dp-1_release) 


15572 
11866 


French application menu is not translated. 
iphoneHeadingCalibrationTimeout returns empty 


Specific bug fixes (7.1.0-dp-1) 


15577 
15571 
15570 
15569 
15568 
15566 
15561 
15556 
15511 
15508 
15507 
15495 
15494 
15472 
15457 
15439 
15321 
15263 
15259 
15191 
14418 
14289 
14056 
13391 
13390 
13262 
12834 
11803 


Execution error caused when trying to set the "visited" property of a text link 
textEncode crashes with encoding UTF-32 

Do not run "after" handlers if an error occurs. 

Referenced jpg crashes application on Linux 

Crash if SSL lib can't load properly - ARTS 

Preferences Mobile Support can't find the SDK for Xcode 6.4 

Tooltip appears for controls out of the visible window 

Mouse focus not synced when object is created 

Erroneous assertion failure logged on server when doing ‘go stack' 

Allow debug mode standalone engines to load script-only TEST_STACKs 

The filename / effective filename of the root script returns empty in LiveCode server. 
[Player] Progress Bar does not update when playing audio files and alwaysBuffer is true 
mobileControlget ID 

Invisible player appears and causes LC to hang 

Repeat for each element subtly different in 7.0 

enabledTracks "can't set this property" in LC 7 

"record sound" is not creating a file in LC7 (Windows) 

Large files can EOF prematurely on Linux. 

DataGrid library missing in standalones 

Windows - Hiding a player in Run mode does not update the screen 

Player doesn't accept filenames starting with file:// 

Update SQLite to 3.8.10.2 

Cannot hide cursor on Mac from LiveCode 6.7 

[[Player]] Make default foregroundColor a colour a colour other than black 

[[Player]] foregroundColor and hiliteColor not saved with stack 

[[Player]] player object in hidden group still displays video image 

[[Player]] enhancement set colour of player controller buttons using backcolor property 
set the RTFText of field does not work on Android 
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6791 Objects are only deleted on idle 
5209 ~=FormattedHeight does not take into account controller 
4123 eraser tool in magnify palette is 1 pixel off 

IDE changes 

Specific bug fixes (7.1.0-rc-2) 
15723 Incorrect wording in Business edition activation screen 
15717 iOS Version resets to 5.1.1 


Specific bug fixes (7.1.0-dp-1) 


15580 
15545 
15535 
15522 
15515 
15510 
15478 
6649 


Mobile Support JDK path not updated after changing it 

Setting spaceAbove or spaceBelow on the first line of a table breaks it 

Magnify palette cannot be used in a standalone 

position of cell editing field in basic table field 

Find and replace does not support arrow keys 

Project Browser forces the unlocking of the cursor 

message box does not auto-scroll 

Editing a table field cell shows focus at the wrong place when margins are changed. 
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LiveCode Builder changes 
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